home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 051-060 / amok52 / oberonced / obced.dok < prev    next >
Text File  |  1993-11-04  |  5KB  |  125 lines
  1.  
  2.                             ObCED-Dokumentation
  3.  
  4. Autor: Achim Siebert, Nobileweg 40, 7000 Stuttgart 40.
  5.  
  6. Dieses  Programm  ist absolut Public Domain (vielleicht eines der letzten -
  7. Spenden jedoch jederzeit willkommen).  Macht damit, was ihr wollt!  Ich bin
  8. jederzeit  dankbar  für  sinnvolle  Verbesserungsvorschläge.   Solltet  ihr
  9. geniale  Verbesserungen  selbst  vornehmen,  so  laßt  mir bitte eine Kopie
  10. zukommen.
  11.  
  12.  
  13. Was tut das Programm?
  14.  
  15. ObCED/ObCEDCall  startet OBERON und OLink von CygnusEd aus und zeigt Fehler
  16. im CygnusEd an.  AREXX nicht nötig (aber sinnvoll).
  17.  
  18. Programmaufruf: Run ObCED [c-svbcrntmdig1238] [l-bsmdi]
  19.                 ObCED     [c][l][e][opt] |[next] |[prev] |[first] |[quit]
  20.                 ObCEDCall [c][l][e][opt] |[next] |[prev] |[first] |[quit]
  21.                 
  22. Voraussetzungen für einwandfreies Arbeiten des Programms:
  23.  
  24. CygnusEd Professional Release 2 im Speicher.
  25. "OBERON:Fehler-Meldungen" müssen vorhanden sein.
  26. "T:" muß existieren (am besten in der RAM:).
  27. Befehle "stack" und "path" im Verzeichnis "C:".
  28. Programmname   muß  die  Extension  ".mod"  beinhalten  (logisch)  und  dem
  29. Modulnamen entsprechen (auch logisch).
  30.  
  31. Die  erzeugten  Dateien  werden  automatisch  in  das  richtige Verzeichnis
  32. geschrieben.  Auch die Verwendung von "txt"-Schubladen ist möglich.
  33.  
  34. Speicherverbrauch: knapp 45k.
  35.  
  36. Beschreibung der Programm-Argumente:
  37.  
  38. Beim  ersten  Start  von  ObCED sind nur die zwei Argumente c-...  und/oder
  39. l-...   möglich.  c- gefolgt von den gewünschten Compiler-Optionen, die als
  40. Default  benützt  werden  sollen,  l- entsprechend für die Linker-Optionen.
  41. (Genau wie bei OMake).
  42.  
  43. Achtung:   im  Gegensatz  zur ersten Version von ObCED werden bei Start von
  44. ObCED  ohne  Argumente Compiler und Linker auch ohne jede Option gestartet,
  45. falls diese nicht mit dem Argument "opt" explizit angefordert werden!
  46.  
  47. ObCED wartet nun im Hintergrund darauf, mit folgenden Argumenten aufgerufen
  48. zu werden (von "sich selbst", von ObCEDCall oder von AREXX):
  49.  
  50. c :    Compiler-Aufruf.              \
  51. l :    Linker-Aufruf.                 > jede Kombination möglich.
  52. e :    Start des fertigen Programms. /
  53. opt:   Fragt nach Compiler-, Linker- bzw. Programm-Optionen.
  54.        Voreinstellung für Compilieren und Linken : "-md".
  55.        Nur in Verbindung mit "c", "l" und/oder "e" möglich.
  56. first: Anzeige des ersten Fehlers, falls vorhanden.
  57.        Wird beim Compilieren automatisch aufgerufen,  wenn der Compiler ein
  58.        Fehler-File erzeugt.
  59. next:  Anzeige  des  nächsten  Fehlers, falls in der  gleichen Datei, sonst
  60.        Anzeige des ersten Fehlers, falls Fehler-Datei gefunden.
  61. prev:  Anzeige des vorhergehenden Fehlers entsprechend "next".
  62. quit:  was wohl?
  63.  
  64. Wird  ObCED,  wenn  es schon geladen ist, ohne Argumente aufgerufen, so hat
  65. dies die gleiche Wirkung wie Aufruf mit dem Argument "quit".
  66.  
  67. ObCEDCall:   Für  diejenigen,  die  AREXX  nicht  besitzen.   Dieses kleine
  68. Programm schickt dem laufenden ObCED die gewünschte Option.  Aufruf genauso
  69. wie  ObCED.   Am  besten resident machen und von CygnusEd aus per Makro mit
  70. der  gewünschten  Option  aufrufen.   Ist  ObCED  noch  nicht geladen, dann
  71. versucht ObCEDCall, dieses zu starten (ObCED sollte daher im aktuellen Pfad
  72. zu   finden   sein,   am  besten  ins  C:   kopieren!).   Vergleichbar  der
  73. Funktionsweise von CygnusEds "ED".
  74.  
  75.  
  76.                                 Beispiele:
  77. 1.
  78.  
  79. Aufruf: ObCEDCall cleopt
  80. oder:
  81. ObCEDCall -elcopt
  82. oder:
  83. ObCEDCall optlec ...
  84.  
  85. Funktion:   fragt  nach  Compiler-  und Linkeroptionen, startet OBERON und,
  86. falls keine Fehler vorhanden waren, OLink, fragt nach Programm-Optionen und
  87. führt das fertige Programm mit diesen Optionen aus.
  88.  
  89. 2.
  90.  
  91. Aufruf:
  92.  
  93. ObCEDCall prev
  94.  
  95. Funktion:   falls eine Fehlerdatei (...modE) vorhanden ist und dieses Modul
  96. schon  compiliert  wurde,  Anzeige des vorausgehenden Fehlers.  Wurde nicht
  97. mit Hilfe von ObCED compiliert, dann Anzeige des ersten Fehlers.
  98.  
  99.  
  100.                            Aufruf mittels AREXX:
  101.  
  102. RX "address ob_ced; option"
  103.  
  104.    wobei  "option"  das gleiche ist wie die ObCED(Call)-Optionen, d.h.  die
  105. obigen Beispiele sehen dann folgendermaßen aus:
  106.  
  107. 1. RX "address ob_ced; cleopt"   oder:  RX "address ob_ced; copt;lopt;eopt"
  108. 2. RX "address ob_ced; prev"
  109.  
  110. Natürlich  kann  auch  mit  der  Funktion  "Send  Dos/ARexx command..." des
  111. CygnusEd  direkt  "address  ob_ced;  option"  eingegeben werden (und dieser
  112. Befehl als Makro auf irgendeine Taste gelegt werden).  Der explizite Aufruf
  113. von RX kann somit entfallen.
  114. Achtung:   ObCED  möglichst keine unbekannten Optionen senden.  Ihr könntet
  115. bekommen,  wonach  ihr  verlangt  ("address  ob_ced;Quatsch"  z.B.  startet
  116. OBERON, da in dem Befehl ein "c" vorkommt).
  117.  
  118. TIP:   CygnusEd  mit  der Option "-keepio" starten.  Die Fehleranzeige wird
  119. dadurch   enorm   beschleunigt,   da  CygnusEd  dann  nicht  jedesmal  sein
  120. Befehlsfenster aufmacht, was doch einiges an Zeit kostet.
  121.  
  122.  
  123.  
  124. Viel Spaß beim Programmieren. Achim.
  125.